home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 15 / BBS in a box XV-1.iso / Files / System 7 / M / Menu Grabber 1.2.sit / Menu Grabber 1.2 / Menu Grabber Help.rsrc / STR#_1026.txt < prev    next >
Encoding:
Text File  |  1994-10-17  |  7.0 KB  |  285 lines
  1. 
  2.  
  3. 
  4.  
  5. ‹
  6.  
  7. ‹
  8.  
  9. √•How Does Menu Grabber Work?
  10.  
  11. 
  12.  
  13. 
  14.  
  15. xAbout Menu Events
  16.  
  17. 
  18.  
  19. Á
  20.  
  21. Á
  22.  
  23. Á
  24.  
  25. 
  26.  
  27. When the Menu Events extension is installed on a Macintosh, all
  28.  
  29. high-level-event-aware applications running on that machine gain support
  30.  
  31. for Menu events.  Menu events are a class of Apple events which allow a
  32.  
  33. sender to query an application‚Äôs menus and menu items, and to select its
  34.  
  35. menu items.  (See the help file for the Menu Events extension to learn
  36.  
  37. more about the Apple event syntax for Menu events.)
  38.  
  39. 
  40.  
  41. 
  42.  
  43. 
  44.  
  45. In order for Menu events to work across an AppleTalk network, the target
  46.  
  47. machine and application must meet the following conditions:
  48.  
  49. ‚Ä¢  program linking started in Sharing Setup control panel
  50.  
  51. ‚Ä¢  program linking allowed to user or guest through Users & Groups
  52.  
  53. control panel
  54.  
  55. ‚Ä¢  remote program linking allowed through application‚Äôs Sharing dialog
  56.  
  57. ‚Ä¢  Menu Events extension installed
  58.  
  59. 
  60.  
  61. 
  62.  
  63. NOTE (technical, but important):  Even with remote program linking
  64.  
  65. allowed, most applications run in a mode where they will not permit user
  66.  
  67. interaction in response to an event from another machine.  Menu Events
  68.  
  69. always requests user interaction to make the target application active, as
  70.  
  71. it would normally be when it senses a menu selection.  Menu Events is
  72.  
  73. programmed to overcome this problem.  If you want to allow remote Menu
  74.  
  75. events (such as sent by Menu Grabber) to work on applications running in
  76.  
  77. the default kAEInteractWithLocal interaction mode, leave Menu Events
  78.  
  79. unlocked.  Otherwise, lock it using the Get Info dialog, so that applications
  80.  
  81. can decide for themselves whether to allow remote control.  This choice
  82.  
  83. does not affect the acceptance of Menu events by applications which are
  84.  
  85. running in the kAEInteractWithSelf (always reject) or kAEInteractWithAll
  86.  
  87. (always accept) interaction mode.
  88.  
  89. 
  90.  
  91. After installing the Menu Events extension on the target machine, you
  92.  
  93. must restart that machine to enable support for Menu events.  An icon
  94.  
  95. appears at startup to confirm that the extension has initialized
  96.  
  97. successfully.  The icon includes a little padlock if Menu Events has been
  98.  
  99. locked against remote senders.
  100.  
  101. 
  102.  
  103. 
  104.  
  105. 
  106.  
  107. xSelecting a Target Application
  108.  
  109. 
  110.  
  111. Once you have installed the Menu Events extension on the target machine,
  112.  
  113. you are ready to try Menu Grabber.  You may decide to run Menu Grabber
  114.  
  115. on the same machine, as a first test, but to be certain that Menu events
  116.  
  117. will work for a certain target application across the network, you should
  118.  
  119. also try grabbing its menus from another machine.
  120.  
  121. 
  122.  
  123. 
  124.  
  125. To grab an application‚Äôs menus, press the Grab‚Ķ button in the Menu
  126.  
  127. Grabber dialog, then select the zone, machine, and application you want.
  128.  
  129. If the machine‚Äôs name does not appear, check that it is connected to the
  130.  
  131. network, and that program linking is started.  If the application‚Äôs name
  132.  
  133. does not appear, check that it is open, and that remote program linking is
  134.  
  135. allowed in its Sharing dialog.  If you have to turn on remote program
  136.  
  137. linking, you must quit the application first.  If the check box remains
  138.  
  139. grayed out after quitting the application, and the application is neither
  140.  
  141. locked nor on an unwritable volume, it is likely that the application is not
  142.  
  143. high-level-event-aware ‚Äî in other words, it doesn‚Äôt support program
  144.  
  145. linking, and can‚Äôt be controlled by Menu Grabber.
  146.  
  147. 
  148.  
  149. Unfortunately, some applications, such as any version of Finder which
  150.  
  151. predates Power Macintosh (version 7.1.2), are programmed in such a
  152.  
  153. way as to ignore high-level events which they do not understand, such as
  154.  
  155. Menu events.  If it seems to be taking a long time to grab the application‚Äôs
  156.  
  157. menus, you can wait 30 seconds for the attempt to time out, or press
  158.  
  159. Command-Period to cancel the attempt.  A few other applications
  160.  
  161. (Microsoft‚Äôs, especially) actively prevent system event handlers from
  162.  
  163. working; you will recognize them by the error message, ‚ÄúThe target
  164.  
  165. application has prevented the usual handling of the Menu event.  Menu
  166.  
  167. events should not be used with this application.‚Äù
  168.  
  169. 
  170.  
  171. If all goes well, the Menu Grabber dialog changes to show that it has
  172.  
  173. grabbed the application‚Äôs menus, and the menu bar changes to match.  If
  174.  
  175. you are using a color display, the menu bar turns red, and all grabbed
  176.  
  177. menus have white titles and white-on-black items, to make it obvious that
  178.  
  179. these are not Menu Grabber‚Äôs own menus.
  180.  
  181. 
  182.  
  183. To select another application, repeat the procedure.  To revert to Menu
  184.  
  185. Grabber‚Äôs own menus, press the Revert button, or press Escape or
  186.  
  187. Command-Period.
  188.  
  189. 
  190.  
  191. 
  192.  
  193. 
  194.  
  195. xUsing Grabbed Menus
  196.  
  197. 
  198.  
  199. Having grabbed the menus of a target application, you can control that
  200.  
  201. application by pulling down menus and selecting menu items from within
  202.  
  203. Menu Grabber.  If you have pressed any modifier keys (Shift, Control,
  204.  
  205. Option, Command), and the target machine is running Menu Events version
  206.  
  207. 1.1.2 or later, these modifiers are applied to the menu selection.
  208.  
  209. Meanwhile, the target application and its menus continue to work as usual.
  210.  
  211. 
  212.  
  213. 
  214.  
  215. Menu Grabber faithfully reproduces standard hierarchical (cascade)
  216.  
  217. menus, Command-key shortcut equivalents, bullets and check marks, and
  218.  
  219. styles such as underlining and italics.  It does not reproduce icons
  220.  
  221. attached to menu items.  If it encounters a non-standard menu (one which
  222.  
  223. uses a menu definition procedure other than the standard system 'MDEF'),
  224.  
  225. it substitutes a menu containing a grayed-out item saying ‚Äúnon-standard
  226.  
  227. menu,‚Äù because Menu Grabber does not have access to that function.  If a
  228.  
  229. menu is unavailable for any reason, you will see a similar ‚Äúunavailable
  230.  
  231. menu‚Äù indication.  Keyboard, Help, and Application menus are never
  232.  
  233. grabbed; selecting an item from these menus does not cause a Menu event
  234.  
  235. to be sent to the target application.
  236.  
  237. 
  238.  
  239. NOTE:  The state of the modifier keys at the time you grab an
  240.  
  241. application‚Äôs menus does not affect the appearance of the grabbed menus.
  242.  
  243. The items are portrayed according to the application‚Äôs current menu
  244.  
  245. structure, which may be constant, or may reflect the state of the
  246.  
  247. modifier keys at the time of a previous menu selection, depending on how
  248.  
  249. the application was programmed.  Although you may not be able to see
  250.  
  251. items in their ‚Äúmodified‚Äù state through Menu Grabber, you can still use
  252.  
  253. the modifier keys to select a modified menu command, as long as the
  254.  
  255. application does not shuffle or delete items when it detects the state of
  256.  
  257. the modifier keys.
  258.  
  259. 
  260.  
  261. Menu Grabber adds an extra disabled item to the bottom of each grabbed
  262.  
  263. menu, to show the menu ID.  This may help you if you are writing a
  264.  
  265. program or script to send a Menu event to the application.
  266.  
  267. 
  268.  
  269. The reproduction of the target application‚Äôs menu bar is static.  If you
  270.  
  271. need to bring it up to date, because menus may have been added or
  272.  
  273. deleted, or items enabled or disabled, you must repeat the grabbing
  274.  
  275. procedure.  The simple way to do this is to press the Return or Enter key
  276.  
  277. twice ‚Äî once to bring up the program selection dialog, and once to accept
  278.  
  279. the selection.
  280.  
  281. 
  282.  
  283. 
  284.  
  285.